Saltar al contenido principal

Instalación local de Wiki.js

Versión: 2.x
Tema: Instalación local usando Docker en macOS o Windows

🧰 Requisitos previos​

Para realizar una instalación local de Wiki.js en macOS o Windows, se requiere:

  • Docker Desktop (incluye Docker y Docker Compose)
  • Permisos de administrador para ejecutar contenedores

📌 Es importante prestar atención al usuario, base de datos y contraseña definidos. Estos deben coincidir exactamente con la configuración del contenedor de Wiki.js.

🗂️ Preparar el entorno de trabajo​

  1. Crea una carpeta en tu equipo donde alojarás los archivos de configuración.
  2. Dentro de esa carpeta, crea un archivo llamado docker-compose.yaml con el siguiente contenido:
services:
  db:
    image: postgres:17-alpine
    environment:
      POSTGRES_DB: wiki
      POSTGRES_PASSWORD: wikijsrocks
      POSTGRES_USER: wikijs
    logging:
      driver: "none"
    restart: unless-stopped
    volumes:
      - db-data:/var/lib/postgresql/data

  wiki:
    image: ghcr.io/requarks/wiki:2
    depends_on:
      - db
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: wikijsrocks
      DB_NAME: wiki
    restart: unless-stopped
    ports:
      - "80:3000"

volumes:
  db-data:

🚀 Iniciar los contenedores​

  1. Abre la terminal de Windows (CMD o PowerShell) o Terminal en macOS.
  2. Navega a la carpeta donde está el archivo docker-compose.yaml.
  3. Ejecuta el siguiente comando:
docker compose up -d

⚠️ Asegúrate de que Docker esté corriendo antes de ejecutar el comando.

🌐 Acceder a la instalación​

Una vez que los contenedores estén en funcionamiento:

Abre tu navegador y accede a: http://localhost

Aparecerá la pantalla de configuración de Wiki.js donde deberás:

  1. Crear un usuario y contraseña de administrador.

  2. Definir la URL base de tu Wiki.

En entorno local puedes inventarla (por ejemplo: http://localwiki).

🏁 Conclusión​

¡Listo! 🎉 Ahora puedes comenzar a trabajar con tu instalación local de Wiki.js.
Desde la interfaz podrás:

  • Crear y editar documentos con diferentes editores (Markdown, WYSIWYG, etc.)
  • Organizar contenido en grupos, categorías y etiquetas
  • Gestionar usuarios, roles y permisos
  • Configurar autenticación, notificaciones, integraciones y más